home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1997 May
/
EnigmA AMIGA RUN 18 (1997)(G.R. Edizioni)(IT)[!][issue 1997-05][EAR-CD II].iso
/
earcd
/
util
/
sys
/
msys_1_2.lha
/
Doc
/
makelink.doc
< prev
next >
Wrap
Text File
|
1996-02-10
|
3KB
|
70 lines
C/MakeLink C/MakeLink
NAME
MakeLink -- create filesystem links. (V42)
SYNOPSIS
MakeLink Source Target [HARD] [SOFT] [FORCE]
TEMPLATE
MakeLink "FROM/A,TO/A,HARD/S,SOFT/S,FORCE/S"
FUNCTION
MakeLink creates links to other files or directories. A link is a
directory entry that points to other file or directory. There are
two kinds of links:
hard links - this link points to an already existing file or
directory located on the same partition;
soft links - such links may point to any objects (including
devices, volumes, and partitions) and as such are
more flexible.
MakeLink creates a Source name link that points to Target. HARD
options (default) indicates that it is a hard link. SOFT option
indicates a soft link. You can't specify both HARD and SOFT. When
creating hard links to directories FORCE option must be given.
MakeLink detects circular (i.e. to parent directories) dependencies
during creation of hard links and will not create such links.
INPUTS
Source - name of symbolic link to create.
Target - name of link target. In case of hard links must be an
existing directory or file name.
HARD - indicates hard link (default).
SOFT - indicates soft link.
FORCE - this keyword must appears during creation of hard links to
directories, ignored for soft links.
RESULT
RETURN_FAIL - if 'dos.library' couldn't be opened or command line
arguments couldn't be processed or both HARD and SOFT
options appeared on command line.
RETURN_ERROR - circular dependency was detected (ERROR_OBJECT_LINKED),
link couldn't be created or some other error.
RETURN_OK - if a link was created.
EXAMPLE
MakeLink SYS:Utilities/More C:PPMore
; Creates SYS:Utilities/More file that in reality is the C:PPMore.
MakeLink DF0.link DF0: SOFT
; Creates DF0.link pseudo-directory which points to a disk in
; DF0: drive.
MakeLink Work:Music/Lyrics Work:Docs/Lyrics FORCE
; Creates Work:Music/Lyrics directory which points to
; Work:Docs/Lyrics
NOTES
Links (especially soft) are not fully supported in current AmigaDOS
releases. This is why soft links - even pointing to files - will
look like directories to most of the programs. Creating soft links
to handlers (like SPEAK:) may yield very strange results.
MakeLink is pure and can be made resident.
BUGS
In FastFileSystem before version 40 when referencing a soft link it
must be the last part of the path. There is also a bug regarding
removing the target of the hard link (in FastFileSystem, too).
SEE ALSO
dos.library/MakeLink().